Next: padline, Previous: mkdirp, Up: Specific header arguments [Contents][Index]
:commentsBy default code blocks are tangled to source-code files
without any insertion of comments beyond those which may already
exist in the body of the code block. The :comments
header argument can be set as follows to control the insertion of
extra comments into the tangled code file.
no The default. No extra comments are inserted
during tangling.link The code block is wrapped in comments
which contain pointers back to the original Org file from which
the code was tangled.yes A synonym for “link” to
maintain backwards compatibility.org Include text from the Org mode file as a
comment. The text is picked from the leading context of the
tangled code and is limited by the nearest headline or source
block as the case may be.both Turns on both the “link” and
“org” comment options.noweb Turns on the “link” comment
option, and additionally wraps expanded noweb references in the
code block body in link comments.